home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / lightwave / utilities / fountain / particlefountain.doc < prev    next >
Text File  |  1994-10-31  |  10KB  |  346 lines
  1. Movement - Particle Fountain 1.0,
  2.  
  3. Copyright (c)1993 Jason Linhart and Chris Minshall. All rights reserved.
  4.  
  5. Movement - Particle Fountain is copyrighted FREEWARE, it comes with ABSOLUTELY
  6. NO WARRANTY or GUARANTEES. It is distributed with the hope that it will be
  7. useful.  It may be freely distributed to any bulletin board, network site,
  8. and/or public domain collection, as long as no fees (other than nominal media
  9. fees) are collected during its distribution.  It is NOT public Domain.  All
  10. rights are reserved by the programmers. 
  11.  
  12. Movement - PF CAN be used for commercial purposes without expressed written
  13. consent from the programmers.  If you do, please contact us,  we want your
  14. input for further versions of this software and we would like to see a VHS copy
  15. of the production that it was used in..  We are also interested in creating
  16. custom motion algorithms. 
  17.  
  18. If you are overcome with the need to compensate us for our work, you can send
  19. either PEZ dispensers to Jason, or White Castle hamburger coupons to Chris, or
  20. if you are wealthy and generous, we could always use BIGGER and BETTER
  21. HARDWARE.  : )   Your suggestions are also welcome.
  22.  
  23. The programmers can be contacted at:
  24.  
  25. Jason Linhart
  26. E-Mail:  c451687@mizzou1.missouri.edu
  27. Snail Mail:  700 Poplar St.
  28.              Boonville, MO 65233
  29.  
  30. Chris Minshall
  31. E-Mail:  C451687@mizzou1.missouri.edu
  32. Snail Mail:  1700 Forum Blvd. Apt 101
  33.              Columbia, MO 65203
  34.  
  35.  
  36.  
  37. Movement - Particle Fountain 1.0
  38.  
  39. For use with Lightwave 2.0 Copyright NewTek, Inc.
  40.  
  41. Motion Algorithms by Jason Linhart
  42. Interface by Chris Minshall
  43. Developed in SAS/C 6.0
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52. Purpose:
  53. ========
  54.  
  55.     Movement - PF (Particle Fountain) was created as an internship project to
  56. simulate the launch of a standard projectile according to physical equations
  57. and constants.  This module runs a launch simulation and then modifies a
  58. Lightwave 2.0 scene file to include the new object motions.  Additional
  59. parameters were also added to transform it into an animators tool to produce
  60. outstanding effects.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. Uses:
  70. =====
  71.  
  72.     This Movement module is flexible and can be used to create a number of
  73. different effects for Lightwave 2.0.  These range from fountains, waterfalls,
  74. and explosions, to rain, bouncing Ping-Pong balls or logos. 
  75. You are not limited by these descriptions, by manipulating the input
  76. parameters, any number of different looks can be achieved.
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83. System Requirements:
  84. ====================
  85.  
  86.     Plain and simple, If you're using Lightwave 2.0 then you can use this!
  87. Plus, the more memory, the better!
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96. Limitations:
  97. ============
  98.  
  99.     Lightwave 2.0 has a limit of 150 objects.  You cannot exceed this limit!
  100. Lightwave will load more than that, but when you enter layout or render a
  101. scene, IT WILL CRASH!!!!  The bounce algorithm is still under development.  It
  102. does work in most instances, but it may not act according to the users wishes.
  103.  
  104. This version does NOT collision detect objects.  It simulates collision with
  105. the ground which is set up in the input scene file with the second
  106. key-frame of the placement object (More on this later and in the
  107. Movement.tutorial file.)
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Instructions:
  115. =============
  116.  
  117.     Movement - PF uses a scene file that was created in Lightwave 2.0 for
  118. information that it needs for launch placement.  All other information in that
  119. input scene is carried over into the output scene.  This is the only way that I
  120. could give users a graphical input for the launch placement.  If it weren't for
  121. the input scene file, users would have to input the launch placement
  122. numerically.
  123.  
  124.  
  125. *** IMPORTANT: ***
  126.  
  127. At least one object must be in the input scene file.  This version
  128. of Movement will use the first object that was loaded into Lightwave during the
  129. creation of the input scene file as its launch placement (i.e. cannon
  130. placement).
  131. The NULL OBJECT is the best choice for the placement object, as it will not
  132. appear in the final rendering.
  133.  
  134.  
  135.  
  136. *** IMPORTANT #2: ***
  137.  
  138. The first object in the input scene (placement object) must have
  139. at least 2 key-frames.  The first key-frame, always set at 0, will correspond
  140. to the position where the objects will be launched from (i.e. cannon).
  141.     
  142. The second key-frame (usually set at 10 or above) corresponds to where the
  143. objects will stop their flight path (i.e. ground).  The EXAMPLE SCENES will
  144. demonstrate the standard set-up for all launch types.  The Movement.tutorial
  145. file will take you step-by-step through this input scene set-up.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152. Input Scene: 
  153. ============
  154.  
  155.     This is the input scene file that Movement - PF will use for the launch
  156. placement.  It is a standard Lightwave 2.0 scene file with at least one object
  157. with two key-frames.
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164. Output Scene:
  165. =============
  166.  
  167.     This is the output scene file that Movement will create.  This file is
  168. compatible with Lightwave 2.0.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175. New Object:
  176. ===========
  177.  
  178.     This is the object that will be used in the launches.  You are not limited
  179. to single point polygons, if you want to launch the cow or your company logo,
  180. you can!
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187. Number of Objects:
  188. ==================
  189.  
  190.     This is the number of objects that will be created and launched.  This
  191. number plus the number of original objects in the input scene file CANNOT
  192. exceed 150 !!!!!!!!
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199. Launch Type:
  200. ============
  201.  
  202.         Point:  launches all objects from a single point in space.
  203.                 SEE EXAMPLE SCENE: Point.scene.
  204.  
  205.  
  206.         Linear: launches all objects from the line (XZ view) between the 2
  207.                 key-frames of the input scene file.
  208.                 SEE EXAMPLE SCENE: Linear.scene.
  209.  
  210.  
  211.         Planar: launches all objects from the bounded area of a flat plane.
  212.                 This plane can be scaled (XZ view) to any dimension in the
  213.                 input scene.
  214.                 Default: 1x1 meter square.
  215.                 SEE EXAMPLE SCENE: Planar.scene.
  216.  
  217.  
  218.         Disc:   launches all objects from the bounded area of a flat disc.
  219.                 This disc can be scaled (XZ view) to any dimension in
  220.                 Lightwave.
  221.                 Default: 1 meter radius.
  222.                 SEE EXAMPLE SCENE: Disc.scene.
  223.  
  224.  
  225.         Ring:   launches all objects from the outside edge of a flat disc.
  226.                 This ring can be scaled (XZ view) to any dimension in
  227.                 Lightwave.
  228.                 Default: 1 meter radius.
  229.                 SEE EXAMPLE SCENE: Disc.scene.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236. End_Behavior:  Same as the end behavior in Lightwave 2.0.
  237. =============
  238.  
  239.             Reset : the objects will reset back to the original location after
  240.                     their last key frame.
  241.  
  242.             Stop : the objects will stop and stay at their final key-frame for
  243.                    the duration of the animation.
  244.  
  245.             Repeat: the objects will repeat their sequence of key-frames for
  246.                     the duration of the animation.  This is the key to a
  247.                     continuous flow of particles!.  A problem does arise if
  248.                     motion blur is turned on for single point particles.
  249.                     When the particles jump from their last key-frame back
  250.                     to the first key-frame, at motion blur path is also
  251.                     drawn.  This leaves a long, straight line in the frame.
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259. Launch Angle: Similar to Raising or Lowering the cannon angle.
  260. =============
  261.  
  262.             0 = straight out - horizontal
  263.  
  264.             90 = straight up - vertical
  265.  
  266.             any other angles will work
  267.  
  268.  
  269.         Movement will calculate a random angle between the High and Low
  270.         settings.  They can both be set at the same angle for direct control.
  271.         (i.e. High 45 and Low 45 will launch all particles at 45 degrees.)
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278. Launch Direction:  Similar to turning the cannon to the left or right.
  279. =================
  280.  
  281.             0 = +X axis
  282.  
  283.             90 = +Z axis
  284.  
  285.             180 = -X axis
  286.  
  287.             270 = -Z axis
  288.  
  289.             360 = +X axis
  290.  
  291.         Movement will calculate a random angle between the High and Low
  292.         settings.  High 360 and Low 0 will launch in a full circle.  For a
  293.         concentrated stream, smaller angles can be set.  Negative launch angles
  294.         are also possible.
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302. Launch Velocity - High and Low :  These are the bounding velocities for the
  303. ===============   object launches.  A good starting place is between 8 and 3,
  304.                   but you can set it as high as you want.  A launch velocity of
  305.                   0 will simulate a drop, but it will not bounce properly in
  306.                   this version of Movement - PF.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314. Frame Dispersion:  The new object launches will be spread out between the High
  315. =================  and Low frame numbers.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323. Bounce Percentage: This is the percentage of bounce that will happen after the
  324. ================== launched object passes the ground.  A good average bounce is
  325.                    between 40% and 65%. 
  326.                    This part of Movement - PF is still under construction, but
  327.                    I included it in this version to be tested. 
  328.                    WARNING: IT MIGHT NOT WORK AS EXPECTED!!!
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. Dissolve Envelope:  This will create a dissolve envelope for each launched
  336. ==================  object.  The High and Low settings are the offset from the
  337.                     last key-frame of the launched objects path.  If the
  338.                     launched object has a motion path over 50 key-frames, with
  339.                     High 15 and Low 5, a random number will be chosen between
  340.                     15 and 5.  Say the random number was 8, a dissolve envelope
  341.                     for the object will begin to dissolve out (0%) at frame 42
  342.                     (50 - 8 = 42) and will be fully dissolved (100%) at frame
  343.                     50.
  344.  
  345.  
  346.